📍 ที่อยู่ — Address Hierarchy

📑Table of Contents

📋01Overview & Scope

หน้า "ที่อยู่" (Address Hierarchy Settings) เป็นหน้าผู้ดูแลระบบสำหรับจัดการข้อมูลทะเบียนราษฎร์ไทย 4 ระดับ · ใช้เป็น base table สำหรับฟิลด์ที่อยู่ในทุกหน้าของระบบ (Company Info · User · WBS · Project · Invoice)

🎯 วัตถุประสงค์ (Purpose)

• จัดการ Tree 4 ระดับ: จังหวัด (Province) → อำเภอ/เขต (District) → ตำบล/แขวง (Subdistrict) → รหัสไปรษณีย์ (Postal Code)
• เพิ่ม · แก้ไข · ลบ · เปิด/ปิด active · ค้นหา (พิมพ์ไทย + EN + postal code)
• นำเข้า CSV จาก DOPA (กรมการปกครอง) · ตามมาตรฐาน TIS-1099 · annual update
• ส่งออก CSV / Excel / JSON สำหรับ backup + integration
• ดูสถิติ count แต่ละระดับ (77 · 928 · 7,400+ · 5,400+)
• รองรับ ภาษาคู่ TH (default) + EN (Romanization ตาม Royal Thai General System of Transcription)
• Bulk update postal code (สรรพากร update postal ใหม่)

📐 Scope

👥 ผู้มีสิทธิ์ (per Role&Privilege.docx · "ที่อยู่")

🏛️ Thai Address Standards Reference

⚙️02Tech Stack

อ้างอิงจาก ConstructQ_SystemArchitecture_v2.0.html

⚛️ Frontend (Web)

⚙️ Backend (API)

🐘 Data Layer

🎨03UI Layout & Components

ภาพรวมหน้าจอ + Component หลัก พร้อมตำแหน่ง

🧩 Component Tree

<AddressPage>                                  // app/setting/master/address/page.tsx (RSC)
  <Breadcrumb />
  <PageHeader title="ที่อยู่" />
  <ActionBar>                                   // §5.1
    <ImportButton onClick={openImportModal} />
    <ExportButton onClick={exportAddress} />
    <AddProvinceButton onClick={addProvince} />
  </ActionBar>
  <HierarchySchema />                           // Visual: Province → District → Subdistrict → Postal
  <StatsBar>                                    // §5.2 — 4 stat cards
    <StatCard ico="🏛️" label="จังหวัด" />
    <StatCard ico="🏘️" label="อำเภอ/เขต" />
    <StatCard ico="📌" label="ตำบล/แขวง" />
    <StatCard ico="📮" label="รหัสไปรษณีย์" />
  </StatsBar>
  <SplitLayout>
    <TreePanel>                                 // §5.3 · L · 380px
      <SearchInput onInput={filterTree} />
      <TreeVirtualized>                         // react-window
        <ProvinceNode> <DistrictNode> <SubdistrictNode> </...>
      </TreeVirtualized>
    </TreePanel>
    <DetailPanel>                               // §5.4 · R · flex 1
      <EmptyState />                            // ถ้ายังไม่ได้เลือก
      <AddressForm>                             // RHF + Zod
        <CodeField readonly />
        <ThNameField />
        <EnNameField + RomanizeBtn />
        <PostalField />                         // เฉพาะ subdistrict
        <ActiveSwitch />
      </AddressForm>
      <ActionBar>
        <SaveBtn /> <DeleteBtn /> <ResetBtn />
      </ActionBar>
    </DetailPanel>
  </SplitLayout>
  <ImportModal>                                 // §5.7 — drag-drop + preview
    <FileDropzone />
    <PreviewTable />                            // first 20 rows + validation errors
    <ImportProgress />
  </ImportModal>
  <DeleteConfirmModal />                        // §5.8 — cascade warning
</AddressPage>

📐 Layout Grid (Desktop ≥1280px)

📥04Base Loads (Initial)

ข้อมูลที่ต้องโหลดเมื่อเปิดหน้าครั้งแรก

🔄 RSC Initial Fetch

// app/setting/master/address/page.tsx
import { getAddressTree, getAddressStats } from "@/lib/api/addresses";
import { auth } from "@/lib/auth";
import { redirect } from "next/navigation";

export default async function AddressPage() {
  const session = await auth();
  if (!session)                                redirect("/login");
  if (session.user.role !== "platform_admin")  redirect("/403?reason=address");

  // Parallel fetch — RSC streams
  const [tree, stats] = await Promise.all([
    getAddressTree(),       // GET /api/v1/addresses/tree (province-only · lazy load children)
    getAddressStats(),      // GET /api/v1/addresses/stats
  ]);

  return <AddressClient initialTree={tree} initialStats={stats} />;
}

📊 API Calls on Mount

📥 Sample Response — /api/v1/addresses/tree (provinces)

{
  "data": [
    {
      "id": "50",                       // TIS-1099 2-digit province code
      "type": "province",
      "code": "50",
      "name_th": "เชียงใหม่",
      "name_en": "Chiang Mai",
      "active": true,
      "child_count": 25,                // districts count
      "version": 1,
      "updated_at": "2025-01-15T00:00:00Z"
    },
    {
      "id": "40",
      "type": "province",
      "code": "40",
      "name_th": "ขอนแก่น",
      "name_en": "Khon Kaen",
      "active": true,
      "child_count": 26,
      "version": 1
    },
    /* ... 77 provinces ... */
  ],
  "meta": { "total": 77 }
}

⚡ Client Hydration (SWR + Virtualization)

"use client";
import useSWR from "swr";
import { FixedSizeList } from "react-window";

export default function AddressClient({ initialTree, initialStats }) {
  const { data: tree, mutate: mutateTree } = useSWR("/api/v1/addresses/tree", fetcher,
    { fallbackData: initialTree, dedupingInterval: 86_400_000 }); // 24h
  const { data: stats } = useSWR("/api/v1/addresses/stats", fetcher,
    { fallbackData: initialStats, dedupingInterval: 86_400_000 });

  // Flatten tree to array for react-window (compute only expanded + filter)
  const visibleRows = useMemo(() => flattenVisible(tree, expanded, filter), [tree, expanded, filter]);

  return (
    <FixedSizeList
      height={600} itemCount={visibleRows.length} itemSize={32}>
      {({ index, style }) => (
        <TreeRow style={style} item={visibleRows[index]} onExpand={lazyLoad} />
      )}
    </FixedSizeList>
  );
}

async function lazyLoad(parentId: string) {
  const children = await api.get(`/api/v1/addresses/tree?parent=${parentId}`);
  // merge into tree state
}

🎯05Component → API Mapping

รายละเอียดทุก action ที่กดบนหน้าจอ + API ที่เรียก + UI behavior

5.1 ActionBar ปุ่ม "➕ เพิ่มจังหวัด"

🎬 Behavior

• กด → เปิด DetailPanel mode="create-province" · clear form
• Code field editable (province 2-digit)
• กดบันทึก → POST /addresses · type=province
• หลังสร้างสำเร็จ → append ใน tree · scroll to + auto-select

5.2 StatsBar — 4 Counters

🎬 Behavior

• โหลดจาก /addresses/stats · update เมื่อ create/delete
• SWR mutate ใน optimistic — เพิ่ม/ลด counter ทันที
• Re-fetch หลัง CSV import เสร็จ

5.3 TreePanel — Search + Virtualized Tree

🎬 Behavior

• Click row → highlight + load DetailPanel
• Click chevron ▶/▼ → expand/collapse
• Expand province → lazy GET children (lazy load · 50ms shimmer)
• react-window virtualize · render < 100 DOM rows แม้ tree มี 7,400
• Search input → debounce 200ms → filter ทั้ง 3 levels (TH + EN + postal)
• เมื่อ filter match → auto-expand parent + highlight match yellow

// TreePanel.tsx
const onSearchInput = useDebouncedCallback((q: string) => {
  if (q.length < 2) {
    addressStore.setFilter(null);
    return;
  }
  // Server-side fuzzy search for results > current tree memory
  api.get(`/api/v1/addresses/search?q=${encodeURIComponent(q)}&limit=50`)
    .then(matches => {
      // Auto-expand ancestors of matches
      const ancestorIds = new Set();
      matches.forEach(m => {
        if (m.province_id) ancestorIds.add(m.province_id);
        if (m.district_id) ancestorIds.add(m.district_id);
      });
      addressStore.setFilter({ q, matches, ancestorIds });
      ancestorIds.forEach(id => lazyLoadIfMissing(id));
    });
}, 200);

5.4 DetailPanel — แก้ไขข้อมูล

🎬 Behavior

• เลือก row ใน tree → GET /addresses/:id · populate form
• Code field always read-only (TIS-1099 immutable)
• name_th input → onBlur → call Romanizer · suggest EN ใน input (highlight)
• Postal field — เฉพาะ subdistrict level
• Active switch → ทันที update (optimistic)
• กด 💾 → Zod validate → PATCH · If-Match version
• กด ↺ Reset → revert local changes
• กด 🗑️ ลบ → DeleteConfirmModal (cascade warning)

5.5 ปุ่ม "🔄 Auto Romanize"

🎬 Behavior

• กดหรือ name_th onBlur → ส่งไป /addresses/romanize
• Server ใช้ th-romanize library (RTGS standard)
• คืน suggestion · client เติมใน name_en field
• User edit ทับได้ — ระบบจำว่ามี name_en_overridden=true

5.6 Switch "สถานะ Active"

🎬 Behavior

• Toggle → optimistic update + PATCH ทันที
• ปิด active บน province → confirm modal: "ปิดทั้งจังหวัดจะทำให้ทุก district/subdistrict ภายในใช้ไม่ได้ใน dropdown ต่างๆ"
• Subdistrict ที่ active=false → ยังคงอยู่ในระบบเก่า · ไม่ปรากฏใน typeahead ใหม่
• Active flag = soft hide (ไม่ใช่ delete)

5.7 ปุ่ม "📥 นำเข้า CSV"

🎬 Behavior

• เปิด ImportModal · drag-drop หรือ click upload
• SheetJS ฝั่ง browser อ่านไฟล์ → preview 20 rows แรก
• Validate ทุก row ฝั่ง client ก่อนส่ง — แสดง errors ใน preview table
• ถ้า valid ≥ 1 row → enable "นำเข้า" button
• กด "นำเข้า" → POST multipart · backend ใช้ pgx.CopyFrom bulk insert
• Progress bar แสดง % · ETA
• สำเร็จ → refresh tree + stats · audit log "addresses.imported"
• Mode: append (insert ใหม่ · skip duplicate) หรือ upsert (update existing by code)

// ImportModal.tsx
const onFileSelect = async (file: File) => {
  // 1) Parse client-side (SheetJS)
  const arrayBuffer = await file.arrayBuffer();
  const workbook = XLSX.read(arrayBuffer, { type: 'array' });
  const rows = XLSX.utils.sheet_to_json(workbook.Sheets[workbook.SheetNames[0]]);
  
  // 2) Validate client-side (Zod)
  const errors = [];
  const validRows = [];
  rows.forEach((row, idx) => {
    const result = addressCsvSchema.safeParse(row);
    if (result.success) validRows.push(result.data);
    else errors.push({ line: idx + 2, ...result.error.flatten() });
  });
  
  setPreview({ total: rows.length, valid: validRows.length, errors });
};

const onImport = async () => {
  const formData = new FormData();
  formData.append('file', selectedFile);
  formData.append('mode', mode);
  
  // 3) Stream upload + progress
  const response = await fetch('/api/v1/addresses/import', {
    method: 'POST', body: formData,
    headers: { 'Idempotency-Key': uuidv4() },
  });
  
  const reader = response.body.getReader();
  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    const progress = JSON.parse(new TextDecoder().decode(value));
    setProgress(progress.percent); // 0-100
  }
  
  mutate('/api/v1/addresses/tree');
  mutate('/api/v1/addresses/stats');
  message.success('นำเข้าเรียบร้อย');
};

5.8 ปุ่ม "📤 ส่งออก"

🎬 Behavior

• Modal เลือก format (CSV · XLSX · JSON) + filter (active only · all · provinces only)
• Stream download · Content-Disposition: attachment
• UTF-8 BOM สำหรับ Excel ภาษาไทย
• Filename: addresses_2026-06-03.csv

5.9 ปุ่ม "🗑️ ลบ"

🎬 Behavior

• Modal warning — ระบุจำนวน children ที่จะถูก cascade
• ตรวจการใช้งาน — ถ้ามี organizations.address.subdistrict_id ใช้อยู่ → 409 + แสดง count + ปุ่ม "ดูที่ใช้งาน"
• Soft delete · deleted_at = NOW() · cascade children
• Audit log + NATS broadcast cache invalidation

5.10 Cache Invalidation Broadcast

🎬 Behavior

• ทุก mutation (create/update/delete/import) → backend publish NATS address.changed
• Subscribers: Cache service (Redis flush) · CDN purge (Cloudflare) · Frontend WS (revalidate SWR)
• Frontend ของผู้ใช้อื่น (กำลังใช้หน้า Company Info) → typeahead cache invalidate

🔌06API Reference

📦 Go Struct — Address

type Address struct {
  ID             string     `json:"id"`             // TIS-1099 code (2/4/6 digits)
  Type           string     `json:"type"            validate:"required,oneof=province district subdistrict"`
  Code           string     `json:"code"            validate:"required,numeric,len=2|len=4|len=6"`
  ParentID       *string    `json:"parent_id"`      // null for province
  NameTh         string     `json:"name_th"         validate:"required,max=100"`
  NameEn         string     `json:"name_en"         validate:"required,max=100,ascii"`
  NameEnAuto     bool       `json:"name_en_auto"`   // true = generated by romanize · user can override
  PostalCode     *string    `json:"postal_code"     validate:"omitempty,len=5,numeric"`
  Active         bool       `json:"active"          validate:"-"`
  ChildCount     int        `json:"child_count"`    // computed
  Version        int        `json:"version"`        // optimistic lock
  CreatedAt      time.Time
  UpdatedAt      time.Time
  DeletedAt      *time.Time
}

// Validation:
// - province: code = 2 digits · parent_id = null · postal_code = null
// - district: code = 4 digits · parent_id = province (2-digit) · postal_code = null
// - subdistrict: code = 6 digits · parent_id = district (4-digit) · postal_code = 5 digits required

🐘 DB Schema

CREATE TABLE th_addresses (
  id              VARCHAR(6) PRIMARY KEY,        -- TIS-1099 code (2 · 4 · 6 digits)
  type            VARCHAR(16) NOT NULL CHECK (type IN ('province','district','subdistrict')),
  code            VARCHAR(6) NOT NULL,
  parent_id       VARCHAR(6) REFERENCES th_addresses(id),
  name_th         VARCHAR(100) NOT NULL,
  name_en         VARCHAR(100) NOT NULL,
  name_en_auto    BOOLEAN NOT NULL DEFAULT true,
  postal_code     CHAR(5),
  active          BOOLEAN NOT NULL DEFAULT true,
  version         INT NOT NULL DEFAULT 1,
  created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
  updated_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
  deleted_at      TIMESTAMPTZ,
  
  CHECK (
    (type = 'province'    AND char_length(code) = 2 AND parent_id IS NULL AND postal_code IS NULL) OR
    (type = 'district'    AND char_length(code) = 4 AND parent_id IS NOT NULL AND char_length(parent_id) = 2 AND postal_code IS NULL) OR
    (type = 'subdistrict' AND char_length(code) = 6 AND parent_id IS NOT NULL AND char_length(parent_id) = 4 AND postal_code IS NOT NULL)
  )
);

-- GIN trigram indexes for fuzzy search
CREATE EXTENSION IF NOT EXISTS pg_trgm;
CREATE INDEX idx_addr_name_th_trgm ON th_addresses USING GIN (name_th gin_trgm_ops) WHERE deleted_at IS NULL;
CREATE INDEX idx_addr_name_en_trgm ON th_addresses USING GIN (name_en gin_trgm_ops) WHERE deleted_at IS NULL;
CREATE INDEX idx_addr_postal       ON th_addresses (postal_code) WHERE deleted_at IS NULL;
CREATE INDEX idx_addr_parent       ON th_addresses (parent_id, active) WHERE deleted_at IS NULL;

-- Materialized count
CREATE MATERIALIZED VIEW mv_address_stats AS
SELECT
  (SELECT COUNT(*) FROM th_addresses WHERE type='province'    AND deleted_at IS NULL AND active) AS provinces,
  (SELECT COUNT(*) FROM th_addresses WHERE type='district'    AND deleted_at IS NULL AND active) AS districts,
  (SELECT COUNT(*) FROM th_addresses WHERE type='subdistrict' AND deleted_at IS NULL AND active) AS subdistricts,
  (SELECT COUNT(DISTINCT postal_code) FROM th_addresses WHERE postal_code IS NOT NULL AND deleted_at IS NULL) AS postal_codes,
  NOW() AS snapshot_at;

📊07Data Flow Diagram (DFD)

การไหลของข้อมูลในกระบวนการ CRUD · import · cache invalidation

🔄 ขั้นตอนสำคัญ

1. Tree load: Lazy load per level · Redis 24h cache · 1 query แต่ละ parent
2. Edit: name_th → Romanize TH→EN (RTGS) → fill EN field
3. Save: Validator (TIS-1099 + uniqueness) → PG UPDATE + Audit + NATS
4. CSV Import: Client SheetJS parse + validate → server CopyFrom (bulk) → NATS broadcast
5. Cache invalidation: NATS event → Redis flush + Cloudflare purge + other clients revalidate
6. Export: Stream from PG · CDN edge cache · serve world-wide

🔄08State Machine

8.1 Address Lifecycle

8.2 CSV Import Lifecycle

8.3 Tree Node Lazy Load

↕️09Sequence Diagrams

9.1 Lazy Load Tree + Cache Hit

9.2 Edit + Romanize Auto-suggest

9.3 CSV Import with Streaming Progress

9.4 Delete with Cascade Check

✅10Form Validation

Frontend (Zod) + Backend (validator/v10 + custom Thai validators)

🧪 Zod Schema

// schemas/address.ts
import { z } from "zod";

const provinceCode    = z.string().regex(/^[0-9]{2}$/, "รหัส 2 หลัก");
const districtCode    = z.string().regex(/^[0-9]{4}$/, "รหัส 4 หลัก");
const subdistrictCode = z.string().regex(/^[0-9]{6}$/, "รหัส 6 หลัก");
const postalCode      = z.string().regex(/^[0-9]{5}$/, "รหัสไปรษณีย์ 5 หลัก");

export const addressSchema = z.discriminatedUnion("type", [
  z.object({
    type: z.literal("province"),
    code: provinceCode,
    parent_id: z.null(),
    name_th: z.string().min(2).max(100).regex(/^[฀-๿\s.]+$/, "ภาษาไทยเท่านั้น"),
    name_en: z.string().min(2).max(100).regex(/^[A-Za-z\s.'-]+$/, "อังกฤษเท่านั้น"),
    postal_code: z.null(),
    active: z.boolean(),
  }),
  z.object({
    type: z.literal("district"),
    code: districtCode,
    parent_id: provinceCode,                       // FK province
    name_th: z.string().min(2).max(100).regex(/^[฀-๿\s.]+$/),
    name_en: z.string().min(2).max(100).regex(/^[A-Za-z\s.'-]+$/),
    postal_code: z.null(),
    active: z.boolean(),
  }).refine(d => d.code.startsWith(d.parent_id), {
    message: "รหัส district 4 หลักต้องขึ้นต้นด้วยรหัส province 2 หลัก",
    path: ["code"]
  }),
  z.object({
    type: z.literal("subdistrict"),
    code: subdistrictCode,
    parent_id: districtCode,                       // FK district
    name_th: z.string().min(2).max(100).regex(/^[฀-๿\s.]+$/),
    name_en: z.string().min(2).max(100).regex(/^[A-Za-z\s.'-]+$/),
    postal_code: postalCode,                       // required
    active: z.boolean(),
  }).refine(d => d.code.startsWith(d.parent_id), {
    message: "รหัส subdistrict 6 หลักต้องขึ้นต้นด้วยรหัส district 4 หลัก",
    path: ["code"]
  }),
]);

// CSV row schema (more lenient)
export const addressCsvSchema = z.object({
  type: z.enum(["province","district","subdistrict"]),
  code: z.string().regex(/^[0-9]{2,6}$/),
  parent_id: z.string().regex(/^[0-9]{2,4}$/).optional(),
  name_th: z.string().min(1).max(100),
  name_en: z.string().min(1).max(100),
  postal_code: z.string().regex(/^[0-9]{5}$/).optional(),
  active: z.coerce.boolean().default(true),
});

🔍 Field-by-Field Rules

📏 Custom Backend Validators

// validator/v10 custom registrations
validate.RegisterValidation("tis1099_code", func(fl validator.FieldLevel) bool {
  code := fl.Field().String()
  parent := fl.Parent().FieldByName("ParentID").Interface().(*string)
  t := fl.Parent().FieldByName("Type").String()
  
  switch t {
  case "province":
    return len(code) == 2 && parent == nil
  case "district":
    return len(code) == 4 && parent != nil && len(*parent) == 2 && strings.HasPrefix(code, *parent)
  case "subdistrict":
    return len(code) == 6 && parent != nil && len(*parent) == 4 && strings.HasPrefix(code, *parent)
  }
  return false
})

validate.RegisterValidation("thai_chars", func(fl validator.FieldLevel) bool {
  text := fl.Field().String()
  return regexp.MustCompile(`^[฀-๿\s.]+$`).MatchString(text)
})

validate.RegisterValidation("rtgs_english", func(fl validator.FieldLevel) bool {
  text := fl.Field().String()
  return regexp.MustCompile(`^[A-Za-z\s.'\-]+$`).MatchString(text)
})

🛡️11RBAC & Permissions

per Role&Privilege.docx · "ที่อยู่" = R/C/E/D เฉพาะ Platform Admin

🛡️ Middleware Pattern

r.Route("/api/v1/addresses", func(r chi.Router) {
  r.Use(auth.RequireJWT)
  
  // Public read — accessible to all authenticated users (used by Company Info typeahead etc.)
  r.Get("/subdistricts",         handler.SearchSubdistricts)   // filters active only for non-admins
  r.Get("/postal/{postal}",      handler.LookupByPostal)
  
  // Admin-only routes
  r.Group(func(r chi.Router) {
    r.Use(rbac.RequireRole("platform_admin"))
    r.Get("/tree",         handler.GetTree)                    // includes inactive
    r.Get("/{id}",         handler.GetAddress)
    r.Get("/stats",        handler.GetStats)
    r.Get("/search",       handler.Search)
    r.Get("/romanize",     handler.Romanize)
    r.Get("/{id}/references", handler.GetReferences)
    r.Post("/",            handler.CreateAddress)
    r.Patch("/{id}",       handler.UpdateAddress)
    r.Delete("/{id}",      handler.DeleteAddress)
    r.Post("/import",      handler.ImportAddresses)
    r.Get("/export",       handler.ExportAddresses)
    r.Post("/bulk-update-postal", handler.BulkUpdatePostal)
  })
})

🚪 UI Guard

// app/setting/master/address/page.tsx
export default async function AddressPage() {
  const session = await auth();
  if (!session)                                redirect("/login");
  if (session.user.role !== "platform_admin")  redirect("/403?reason=address");
  // ...
}

⚡12Performance

🎯 Targets

⚡ Optimization Strategies

• Lazy load tree — 77 provinces เริ่มต้น · children load on expand
• react-window virtualization — render < 100 DOM rows
• Redis cache 24h — address มี mutation rate ต่ำมาก (annual update)
• pg_trgm GIN index — fuzzy search ≤ 80ms ที่ 7,400 records
• pgx.CopyFrom — bulk import 7,400 rows ใน < 8s (vs INSERT loop ~5min)
• Cloudflare CDN cache — /export response cached at edge worldwide
• Materialized view — stats counts ไม่ต้องนับใหม่ทุกครั้ง
• SWR dedupingInterval 24h — stable data ไม่ revalidate บ่อย
• Romanize in-memory dict — load Thai dict (~50k entries) ที่ startup · O(1) lookup

🔒13Security & Compliance

🛡️ Threat Model

📋 Audit Events

🇹🇭 Thai Compliance Reference

🔐 Sensitive Operations

• Bulk delete — ตรวจ references ก่อนทุกครั้ง · cascade requires explicit flag
• CSV import upsert — overwrite mode = require additional confirmation modal
• Bulk postal update — เฉพาะ admin · audit log mandatory · email notify backup admin
• Rate limit — POST/PATCH/DELETE: 60/min per admin

🧪14Testing & Acceptance

🎯 Acceptance Criteria

🧪 Test Plan

📋 Definition of Done

• ✅ ผ่าน AC-01 ถึง AC-18
• ✅ Coverage ≥ 85% FE / ≥ 90% BE
• ✅ Lighthouse ≥ 90 (Performance + A11y)
• ✅ DOPA CSV 7,400 rows import ≤ 8s
• ✅ pg_trgm typeahead p95 ≤ 80ms ที่ 500 RPS
• ✅ Romanize ≥ 95% match DOPA official names
• ✅ NATS broadcast → Cloudflare purge tested end-to-end
• ✅ Audit log ครบ 7 events
• ✅ Tree virtualization smooth 60fps
• ✅ TIS-1099 validator property-tested (1000 random)